IviPwrMeter Fetch Channel [CH]

IviPwrMeterChannelAcquisition Capability Group

This VI returns the result from a previously initiated measurement on a specified channel. Call the IviPwrMeter Initiate VI to initiate a measurement before calling this VI.

After this VI executes, the Reading parameter contains an actual reading on the channel specified by the Channel parameter. If the specified channel is not enabled for measurement, this VI returns the Channel Not Enabled (0xBFFA2001) error. The result is in the same unit as the value of the Units property.

Notes

(1) This VI does not check the instrument status. Typically, you call this VI only in a sequence of calls to other low-level driver VIs. The sequence performs one operation. You use the low-level VIs to optimize one or more aspects of interaction with the instrument. If you want to check the instrument status, call the IviPwrMeter Error-Query VI at the conclusion of the sequence.

(2) If an out of range condition occurs, the result is a value indicating that an out-of-range condition occurred. In such a case, the Reading parameter contains an IEEE defined -Inf (Negative Infinity) or +Inf (Positive Infinity) value and the VI returns the Under Range (0x3FFA2001) or Over Range (0x3FFA2002) warning. Test if the measurement value is out of range with the IviPwrMeter Query Result Range Type VI.

	instrument handle The instrument handle that you obtain from the IviPwrMeter Initialize or IviPwrMeter Initialize With Options VIs.
	channel name The name of the channel from which to fetch the measurement. Pass the virtual channel name that you assign to the instrument in the Action Utility. Virtual channel names are aliases for instrument-specific channel strings. The instrument-specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument-specific channel through the Configuration Utility. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument-specific channel names. Default Value: ""
	error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
	instrument handle out The instrument handle that you obtain from the IviPwrMeter Initialize or IviPwrMeter Initialize With Options VIs.
	reading The data read from the power meter.
	error out The error out cluster passes error or warning information out of a VI to be used by other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.